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AUTOMATIC COMPUTER SUBPROGRAM SELECTION FROM 
APPLICATION-PROGRAM LIBRARIES 

By Joseph M, DrozdowsM 
Langley Research Center 

SUMMARY 

A general-purpose program that enables access and use of an alternate library file 
with minimum programing effort by the user has been developed for the Control Data 
series 6000 computer systems. The program is used, prior to loading, to select and 
combine required subprograms from an alternate library file with the user's object file. 

It employs the user's program field lei^h and is called into operation by a control card. 
The program structures that the user program can use include overlay or segmentation. 
This report describes the purpose of the program and the implementation, provides a dis- 
cussion of the program's operation, and gives instructions for the user. 

INTRODUCTION 

Modular programing techniques are currently in widespread use in the development 
of scientific and engineering computer programs at the NASA Langley Research Center. 
These techniques involve the development of frequently used algorithms into modular 
(subprogram) form and the collection of application modules supporting a particular area 
into an appUcation-oriented library. This library can then be employed repeatedly by 
programers working in the same area of application to simplify new-program development. 

A niajor problem, however, for people maintaining their own application-oriented 
library is the complexity and volume of control-card programing that must be performed 
to achieve subprogram selection. 

The Alte rnate Libr ary Access (ALTLIB) program provides a solution to this prob- 
lem. ALTLIB is a general-purpose digital computer program that automates the sub- 
program selection process. ALTLIB analyzes the user's program to determine all 
external requirements; ALTLIB then proceeds to select from the alternate library file 
all subprograms that a user's program requires. The selected subprograms and the 
user's object file are then merged onto a file designated by the user for subsequent load- 
ing and execution. 



GLOSSARY 


TEXT tables 


PIDL table 


LINK table 


ENTR table 


FET 


RANDOM ACCESS 


PRU 


Text and data (TEXT) tables are compiler output tables 
which contain data comprising the subprogram and informa- 
tion necessary for properly relocating the data. Each table 
includes an origin for the data, the data itself, and indicators 
describing relocation (if any) of the three possible locations 
in a data word which may refer to addresses in memory. 
TEXT tables may appear in any order and any number. 

The Program Identification and Length table is a compiler 
output table which contains the subprogram identification 
and declarations concerning common block allocation. The 
PIDL table must appear before any other tables for a given 
subprogram. 

The LINK table is a compiler output table which indicates 
external references (EXTERNALS) within the subprogram. 
Each reference to an external symbol must appear as an 
entry in LINK. 

The ENTR table is a compiler output table which contains a 
list of all the named entry points to the subprogram and its 
associated labeled common blocks. The ENTR table must 
immediately follow the PIDL table. 

The File Environment Table (FET) is a communication area 
initiated by the user; it is interrogated and updated by the 
system and the user during file processing. An FET must 
be declared for each file. The FET is used by the peripheral 
processor input-output routines and Central Program Control 
(CPC) subprograms as well as by the user program. 

FILE A RANDOM ACCESS FILE is a file created to take advantage 
of random access disk capability. Random access is the 
process of obtaining information from or placing informa- 
tion into storage where time required for such access is 
independent of the location of the information most recently 
obtained or placed in storage. 

A physical record unit (PRU) is the smallest amount of 
information transmitted in one continuous burst between a 
computer and a specific input-output device. 
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RA 


RA is the reference address of a program. 

EOF EOF is the designation given to denote an End-of-File, 

where a file represents a stored set of records, tables, or 
other information. 

PROCESS DESCRIPTION AND IMPLEMENTATION 

ALTLIB requires the user to declare three files in his ALT LIB control card: the 
user's program file in object form, the alternate library file in object program form, and 
the file upon which ALTLIB will output the user's program and selected alternate library 
subprograms in object form. 

The user's file and alternate library file are searched for program-identification, 
external, and entry information, ALTLIB makes a table of these data (see ref. 1 for 
additional information on the PIDL, LINK, and ENTR tables). ALTLIB then makes a list 
of subprograms that are needed by the user program from information in the table. This 
list is compared with information about the alternate library. The items compared are 
externals from the user's program and entries from the alternate library. When a posi- 
tive compare is made, the entry of the alternate library is marked selected, and all its 
externals are added to the list of subprograms needed. This process continues until all 
available subprograms are selected. The user's file and selected subprograms are then 
merged onto the designated file, and control is returned to the user. The method of solu- 
tion for different program types varies only in the way files are manipulated. A descrip- 
tion of this process is presented in diagram form in figure 1. 

PROGRAM OPERATION OVERVIEW 

The program ALTLIB is logically divided into three phases and an initialization 
section (see fig. 1). 


Initialization Phase 1 Phase 2 Phase 3 



Fig^lre 1.- ALTLIB program diagram. 
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In the initialization section, the File Environment Tables are created, the user's 
input card is decoded, the random file is opened, and variables are initialized. 

Phase 1 consists of operations on the user's binary file (object file). This binary 
file contains one logical record for each program or subprogram, and these records con- 
sist of a number of tables (PIDL, ENTR, and LINK). Each table contains an identifica- 
tion word which specifies to the loader the procedure to be followed in loading the table. 
The identification word has the following format: 


CN 


WC 


LR 

L 


59 53 47 35 26 17 0 


CN — Code number identifying type of data in table (PIDL, ENTR, LINK, etc.) 
WC — Word count in table (excluding identification word) 

LR — Method of relocation for the load address 
L - Load address 

From the PIDL, ENTR, and LINK tables, ALTLIB forms a table having the format 
shown in figure 2. 

PIDL name 
No. of entries 
No. of links 
ENTR names 


LINK names 


PIDL name 
No. of entries 
No. of links 
ENTR names 


LINK names 
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Figure 2.- Format of Phase 1 TABLE. 




An index of the position of the last entry in this Phase 1 TABLE is stored for later 
use. Another task of Phase 1 is writing the logical records of the user's object file on 
the file where the user's file and selected subprogram will eventually be merged. 

Phase 2 consists of reading the alternate library file to obtain information about 
the PIDL, ENTR, and LINK names for each subprogram. This information is appended 
to the Phase 1 TABLE. An index is set to indicate the last entry in this table. The pro- 
cedures applied to the subprograms in Phase 2 are the procedures applied to the user's 
object deck for table formation. The library file is rewritten as a random file during 
Phase 2. 

Phase 3 consists of indexing through the table formed in Phases 1 and 2 to deter- 
mine which subprograms need to be selected. To accomplish this task, a table is made 
of all the externals of the user's object deck. This list is gathered from that portion of 
the table formed in Phase 1 and is an exclusive list. These externals indicate to ALTLIB 
which subprograms are needed directly. This list is then compared with the ENTR's in 
the table formed in Phase 2. When a true compare is made, this subprogram is marked 
for selection (a 1-bit in the rightmost position of PIDL entry). The externals from this 
subprogram are added to the list of EXTERNALS if they are not there. When the com- 
parison list is completely checked, ALTLIB is ready to merge selected subprograms by 
searching for a select bit set in a PIDL table entry. When it is found, the appropriate 
subprogram is read from the random file and written on the output file. The process is 
completed by putting the combined user's file and selected subprogram on the file selected 
by the user in his ALTLIB control card. 

There are some exceptions in this process for overlay programs. The first excep- 
tion is in Phase 3. When the subprogram -selecting process is complete, a check is made 
to see if the program processed was an overlay type. If it was, the table ‘information 
about the library file is moved to the low storage area of the table, and a flag is set noting 
that this move was made. This first exception leads to the second exception, which is in 
Phase 2. A check is made to see if the library information is available in the low- 
storage-area table. If it is, this information is restored from there rather than reading 
the alternate file again. The process for overlays is to treat them like individual pro- 
grams and to set special flags to denote subprogram selection by a higher level overlay. 
For example, in the main overlay a seven is set in the PIDL word indicating that this sub- 
program has been selected for the entire program. For a primary overlay, a three is set 
which will be cleared only when another primary overlay is read. Secondary overlays are 
marked selected by a 1-bit which is cleared after they are selected and written on the out- 
put file. 

Figure 3 shows a directed flow diagram of the ALTLIB subprograms. This figure, 
the discussion provided for each subprogram, and program listings provide the details for 
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ALTUB 
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Figure 3-- Directed flow diagram of ALTLIB subprograms by phases. 

























































the program ALT LIB. The numbers above the boxes in figure 3 indicate the order in 
which the subprograms are called. 

PROGRAM ORGANIZATION 


ALTLIB COMMON 

The following list contains all the FORTRAN variables appearing in COMMON in 
the program ALTLIB. Dimensional information is given when applicable. 


COMMON 

name 


FORTRAN 

variable 


Description 


TIC 

IOC 


INDL 


TABLE 


BUF(5121) 

lOCN 

lOA 

lOB 

LS 

INDEXL(501) 


LIMTAB 

ITAB(6000) 

LIST(IOOO) 

IRNI 


Buffer used for input and output by all files; 
size is set for 10 tape PRU's 

Input file record count 

Flag for type of overlay to be operated on 

Flag for type of overlay that will be operated 
on next 

Flag to tell if final output file shall have 
same name as input file 

Array used for index of mass storage file; 
index number indicates the number-of- 
records-less-one that the random file can 
contain 

Last value of TABLE 

Array used to store program-identification, 
entry, and external information from user's 
file and library 

Array used to store subprogram names and 
random file index number of that 
subprogram 

Index of record number used in writing the 
random file 
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Description of ALTLIB and Its Subprograms 
A brief description of ALTLIB and of each subprogram is given in the following list: 


Entry point 


Description 


ALTUB 

RDECK 

RCI, WCO, BSP 

lOVLN 

INCREM 

ADDEXT 

CHARS 

STRING 

EXOR 

WORDS 

CRE 

ILSHFT 


Control program for Alte rnate Lib rary Access procedure 

Forms master TABLE of program binary records 

Controls file manipulation processes for reading, writing, 
rewind, and backspacing 

Determines overlay type 

Calculates position in TABLE where next PIDL name will 
be stored 

Develops list of EXTERNALS to be processed 

Interface to STRING 

Moves character strings in a bit basis 

Computes exclusive OR of two names 

Decodes the ALTLIB control card 

Creates File Environment Tables 

Moves data left circular in a specified word 


Information about OPENMS, READMS, WRITMS, ABNORML, and REMARK is contained in 
reference 2. 

The ALTLIB program and its subprograms (subroutines) are discussed briefly in 
the following sections. An ALTLIB program listing is included; also, subprogram listings 
are presented. 
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Program ALTLIB 


AT.T T.tr is a FORTRAN main overlay program that coordinates the task of all sub- 
programs, controls indexes of various tables, and selectively merges final output. The 
flow chart in figure 4 and the program listing that follows show how ALTLIB controls 
program operation. ALTLIB is an overlay program because this format allows the pro- 
gram to load faster and to use less storage. 



Figure 4.- ALTLIB flow chart. (LSTA denotes the last table entry of the user program file; 
LSTB denotes the last table entry of the library file.) 


9 















cc- 02 cc cC: cc cc a: cc co cc CO CD CD co a' cd cd cc cd cc cr a:- cd ac o 2 cr 


CCcCCCCCGTiOjCOCOa' CDCOcOCt: 


<!<.<l<I<<I<<l<<l<l<I< 


<-«a<r<i<<i<t<3.<<i<<<i<i <■ 


f—h—H-H- 
-J ^ ^ ^ 

<t<<.<<<L<<< <!<.<<l 


Q HI 

z tr. 
< 2: 


HJ 

a 


o • 

m rn 


O 

o 


CO 


T> 

< 


CO 

UJ 


CL 

a 

3 

CO 


3 

< 

o 

< 

o 


CO 
J— 'JJ 

2 : '— 

UJ O' 

•* H- 
2T 
^ lU 
ro 

«— a: 

U! U-J 
3 *X3 
03 >'. 

<r 3 
y~ ^ 

• 

_J i-NJ 

O - 

•— • 'Li 
X 2, 
<f 
!~ 2T 


(3 


<y> 

•'■j • 

5' O 
^ ■<:(. <T kr 

^ 

:*C 6 ^ O 

O o: 

O O. x: 

Ct' 





p. 










0 




X 


;o 






—4 





u 


* 

u 






OJ 










0 




3 


3 






0 





-J 




0 ^ 





u 




CO 



■— 



0 






LJ 






LO 





»—4 

si.i 

»■ 


•■ 





»— 4 




<1 



CD 



0 




co 


1 J 











X 

•O- 

to 

U 

0 







0 


1 — 



<I 



3 




CL 








3 







(.‘J 

h- 

. OJ 





<r 


CO 








3 




tij 








■< 





0 

3 

5: 







a 


• — ■ 





•— • 



3 




h- 


0 






ul 





;,D 

3 

<i 

:X 





\\i 

. 1 — • 


3 


•Q 

0 









«.U 


v-4 






l: 





3 

•— « 

tZ. 

3 



•« 


•— < 

— 


X 


< 

0 


XI 



>r 




X 








4C. 








(U 

—4 


0 





• u 


f— 

<3 


—I 

rvj 


>r 




0 , 


3 






U-. 





:r 


>. 

3 



«> 



CJ 

0 

a 


2. 

>o 

0 

Oj 

•w 

— «• 

>r 




X 


<c 











3 

X 

I'X 

X 

uJ 




U_ 

LJ 

0 

z. 


K-4 

w 

0 

-Q. 

UJ 

r^l 





<, 







0 

4L 

— • 




X 

? ;j 

h“ 


3 


OJ 

a- 

3 


3 

•— « 


3 

a.i 

0 

H- 


'>«•' 

>r 




X 


1 Li 




— 

• 

3 

0 

'.0 



•M 

0 


-w 

X) 




O.j 


1*^ 





<3 


rO 

(..r: 

r\j 






3 


X 

UJ 

CO 

.jJ 

3 

V*\J 

ru 



U 

•'X 

V.J 

CO 

<r 


U 

_J 


"v^ 


-j 



f— 

's. 


<I 


<r 




0 




0 

0 


3 


in 

n 



CO 

-•3 

• 

3 

h— 

— ♦ 

H- 


LJ 

0 

»— 

i_j 

♦— 1 


V>4 

OJ 

i3 

►— 

_j 

T4 






Lfc. 


UJ 

0 . 


• 

C» 


► 





vr 


► 

■ 

3 



CT2 

CO 



CO 


< 

3 



1 -^ 




0 

• 


0 


•X 

•0 

;i'\ 

>- 

•n 

—4 



3 


► 

3 

—4 


< 

<l 


t~« 

>-^ 


'X 

<L 



4 :- 

-2 


3 




kI 

>- 



.11 

•y> 

3 







3 


c; 

3 

— ■ 

‘-.i 



\ 




>-4 

h" 

a 

2!^ 

di 

■"-1 

U 

3 

0 


4.U 

-jr 



•— • 

J- 

X 

, ✓ 

3 

•il 

•X 

X 



*-* 

4* 

UC 



X 

>• 

2. 






•Sw 


—4 

3 

t — 4 

•—4 

It 

II 


-L 

3 

<I 

CO 

*» 

1— • 

3 

3 

i— 

X 

*0 

lO 




J* 



3 

3 

C 

< 





z 

2 : 

CO 

3 

-a 

cO 

cO 




LJ 


CO 

<r 

UJ 


<3 

i? 

3 0 

3 

t3 

3 


0 



"-4 


1 ^1 

;2 

— 1 

iJC 

r.i 

U 

u; 


LJ 

3 

;;r 


.■> 

z 


*/' 

m 



5-0 

10 

X 

-i. 

i: 

3 


< II 





il 

X 

X 

3 

^e2 

.3 

.-4 

X. 

0 

i£. 


2 . 

5 : 

2 : 

2" 

3 

<l 

*-H 

'3 

UJ 

3 

'W 

0 

3 

fj) 

UJ 


II 

M 

Ii 

3 

II H-. 

3 

3 

3 

II 


■3 



3 

X 


•-U 

0 



2 


2 : 

21 

2 . 

H- 

3 

2 : 


h- 

0 

ii 

3 

X 

3 

•X 

'.D 

JJ 

rij 

3 

,X .2^ 

3 

3 

-4 

<I 

3 0 

*. J 

*— • 

X 

: Ll 


II 

> 

OL 

u 

a 

LJ 

u 

U 

0 

»-4 

< 

C? 

Ko« 

•— • 

3 

z 

CO 

< 

CJ 

•ij 

CO 

TvJ 

0 

r\J 

<I 

3 X 

<3 

'a. 

■O. 

■"O 

II a 

0 

3 

a 


X 



X 

0 0 

0 

u 

0 

3 

0 

3 

UJ 

•3 

0 

<t 

3 

3 

3 

J5 


.0 

!i> 


sT 

0 

3 ^ -4 

0 

3 

3 

V-4 


'.iT 



■ f. 

•-4 







CJ O 
— ' ‘M * 



m 

0 

lO 

ro 

m 

iO 


ro 

i'O 

ro 

ro 

in 

3 

0- 

0 

’M 

vj- 

n 

0 

CNJ 

^r 


0 

f^ 

nJ- 

0 

0 

3 

0 

0 

3 

0 

3 

3 

ci 

0 

3 

0 

3 

3 

r-U 




cu 

fNj 

nj 

-M 



ro 

0 

0 

0 

0 

3 

0 

0 

0 

3 

0 

0 

3 

0 

0 

0 

3 

0 

0 

3 

0 

0 

0 

0 

O 

3 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

3 

0 

3 

3 

0 

0 

3 

0 

3 

'3 

0 

3 

0 

3 

3 

0 

0 

3 

0 

0 

3 

3 

3 

0 

3 

3 

3 

0 

3 

3 

3 

C.J 

0 

3 

0 

3 

3 

3 

CJ 

0 

3 

3 

3 

3 

3 

3 

0 

3 

3 

3 

3 

0 

3 

0 

3 

0 

0 

3 

3 

3 

0 

0 

0 

0 

3 


10 



OitEODOCcCcDa:. CCcCCCcCjCDcr;CDiIlc£:[riCDCSCQcaarcDOD(r:oCODcD£I3cDCC. OCcCCCcacOCEtECDCDCCOOcrcDtE 

*— < »—* W-4 ►—* ►— * ►-» Hull I_t »»l *— 4 *— « M •— i »— 4 ^-4 *—• »>-4 fc— I 4-^ 4^ »— 4 M 1-^ ►-» t-~4 ^ ►— I »-H *-~t f-H *-4 

I I I I i I I I I I 1 > I • I I I I I I I • • I ■ < > . . . . I . t . I • I I 


<I -a <• <t <3. < < 

I 

I 

I 


h »~ 

<L < 


KJ 

— t :U 
-> 
o 

-s: (.:) 
3 

u_ u 




< 

o 


H-l-l-l-l-h-h-h-Kh-H-K 




a: 

00 









LU 

X 


»— 







CD LiJ 

h-i4 


<X 







2. -I 

a: 


X 







3 (D 

H* 


X 







^ < 

Z 









+ K 

UJ 









L/1 



>. 







LU OC 

o 


iX 


00 





^ c 

z 


< 


UJ 





a; X 

< 


iX. 


UJ o 





X 



OD 


oo ^ 





2: 00 

L/^ 


4—^ 


<. 





X ^ 


• 



UJ T 





o 

<5 

• 



-J tJ 





£X iu 

z 

• 

OJ 


(X 





uu X 

X 




o 





CD O 

lij 

.u 

< 


• z 





2 

»- 


Z 


<r 





-J LJ 

X 

cu 

X 


»— X 


U) 



Z OO 

I.U 

<r 

UJ 


< h- 





+ -1 


h- 

►“ 


o 





<l 

I.L 


-J 




u 


CO 

+ 

O • 

X 

<I 


u 



X 

CD f^ 

*~4 H 

• 

O 



z o 



CD 

r*** 

►~4 

XI • 


oo 


z 


a 

• 

• • 

X 

-J L/' 

PT 

•u •■ 


oo »-• 

V 

<5 

iX 

X rx 

Z • 

t: 2 

O 

Z 2 


Z Q 

X 


o 

a u 

lU X 

<I fX 

•»* 

— « <T 


4—1 2 

<1 


• 

« • 

oO 

h“ O 

1— 

1— X 


< UJ 

oc 

O 


4-^ 

i.u rc 

ZZ- 

X 

3 o 


1— 

X 

• 

M 

1— I 4.^ 

fi: < 

>• c^ 

■:j 

O Q 


Z 

4>^ 

a 

4—4 

•-H K.4 

CL K 

X a 

a 

X X 


o 


UJ 

4>>i4 

l-M 1—4 


<l 


ou a 


o 


• 

W 

>«|4 

oo z 

.X V 

X 

3 


JD • 



UJ 

UJ i U 

ti> •— 

rc «-i: 

lU 

00 7T 


t.u ^ :.JJ 

u 



-1 u 


4— 

:s. 

i>-« 


a -J -J 


1-^ 

ro 

CD CD 

<1 ►- 

-» X 

lJ 

U <t 

o 

M-. 

o 

>—• 

< 

<1 <i 

t— X 

!U 

J 

>- X 

vO 

J X 

ou 

w 

h- 

H- I- 

<1 

X > 



•• 

<1 


'JS IJj 

II 

*t It 


u o 

UJ 

CO rc 

o 

> CX 

<r 

XV -1 



<l >7) 


X 

LJJ CJ 

XV 

X • 3 

u> 

cu 

>— • 

4—4 4— « 

X 

Z LX 

»— ■J' 

O IX 


<. X o 

►-I 

Q < 

1— ♦ 

4-H 4—4 

h- X 

o o 

f<> 

OJ 


'X UJ >- 

_j 


►— 

4—4 >— 4 

• ;.i 

IL 

X 

o 

—1. 

•JJ l*J 

LX 




Z -X 


OJ U 

— — 

— 

X O 

-J 

OJ. — 

OJ 

VXl 4JJ 


<!. >■ fjt 

•X — i O- 

C.1 


UJ ~J 
00 




30 ^ 

:ij 

oo ^ 


*> <l 

**5 H- 


(Ji 

a I 


CO 

<I 


X X T 
o o o 
•r rvj 

X X 


C\J >- 


CQ W 
f- liJ 
00 J 
-j a) 

• ^ 


iU Cl) 
<3. 


h- 

CO 
• oO 


oO 


• 


1 

<i 

3 

o 

CJ 

<. 




3 

li 




3 

X 


3 


a 

< 



X 




..u 


h- 


o 

CjJ 

3 

2 

• 


r-4 

•7i 

:s 

o 

4-4 



:jj 

'■LI 

H* 


.X 

+ 

It 

—4 


3 

X 

3 

V«J 

X 

X 

3 

?' 

3l 

2 

u 

< 

3 



X 

3 



J 

•ij 

X 

•3 

h- 



'C 

a 



OO 

oo 

X 

t 

00 


+ 

< 

3 

3 


o 

«/> 

-a 

H- 

o 

O 

4- 

• u 

3 

UJ 

.3 

3 

1 



3 

« 

X 

ID 

• 

• 

« 

X 

3 


TC 

‘ U 

3 


II 

—4 

4-4 


< 

3 


CD 

3 


*— 

+ 


CD 

o 

X 

lU 

z 


X 

X 

X 



4—4 



Z 

4—4 

o 


< 


<t 

3 

• 

4-4 

■1) 

X 

IX 

3 




'/I 

3 

II 


1— 

:0 

CM 

X 

> 

Q 



H- 

(3 

4-4 

•3 




Lj 

X 

II 


—4 

4—4 

.—4 

X 

CJ 

o 

cJ 

a 

Z 

4-H 

—4 

lC 

Z 

;X 

1— 

<t 



1—4 

4-4 

-D 

4-4 

00,3 

CD 

3 

4-4 

h- 

3 

oo 

OO 

X 


1— 

3 

3 

3 

h- 

3 

Xi 


II 

II 

4—4 

UJ 

h~ 

1-4 ^ 


4—4 

4^ 

4—4 

II 

X) 

<. 

i-U 


1— 

4—4 

4— i 



h- 

II 

3 

M 


•CD 

M 


3 

4—4 


w 

M 


3 

3 

3 


•3 

h— 

il 

4-^ 

4— t 

w 

w 


* ' 



II 

•— » 

4—4 

Z 

X 

> 

U 

oO 

X 

X 

h” 

X 

oO 

>■ 

II 

3 

Q 

< 

> 

3 

< 

X 

h— 

X 


■3 

< 

<I 


o 

X 

L/7 

4— 

4-4 

4—4 

X 

X 

a 

X 

X 

X 

4—4 

X 

4—4 


1— 

O 

o 

3 


l~ 

H-4 

4-4 

3 


4-4 

3 

a 

r— 

4-4 

o 

O 

1— 


4-4 

4—* 

O 

3 

3 

O 

o o 

3 


—4 

—4 

l-l 

•—4 

o 

*-• , 

. ^ 

•-I 

4-4 

4-4 

4-4 


‘“Si 


^ it 


o 

ro ^ 


o o 

-li' >r n 


o 

o 


r\ 


X\ 




T' 

■n 




rH 

CM 

nT 



3 


rn 

r^ 

3 

<M 

CM 



3 

o 

rO >f 

iTV 

o 

rO 

3 

1^ 

cc O 


r- 

CM 

CD 

CD 

>T 

>}■ 

■T 


M" 

jy 

Ul 

rv 

irv 

'U 

•U 

■o 


c- 

r«- 

3 

3 3 0 

3 

-H 


—4 


CM i 

Dy 

CD 

>T 

o 

o 

■3 

O 

O 

o 

O 

o 

o 

o 

o 

3 

o 

O O 

o 

o 

o 


^ ^ 

fH 

r-^ 

4.H 

•H 




•—4 

4—4 

o 

o , 

O 

■3 

3 

3 

o 

o 

o 

3 

3 

3 

3 

O 3 

o 

3 

3 

3 

o o o 

o 

o 

o 

o 

o 

o o 

o 

o 

3 

o 

o 

,3 

O 

3 

O 

3 

3 

3 

O 

O 

3 

3 

3 3 

3 

3 

3 

3 

0 3 3 

o 

o 

3- 

o 

o 

3 3 

o 

3 

3 

o 

a 

O 

3 

3 

O 

‘3 

O 

.3 

O 

3 

3 

3 

3 0 

3 

3 

O 

3 

.300 

o 

o 

O 

o 

o 

3 O 

o 

3 

O 


11 



CDCCQCtncOcDoCCDCCcCCDOC. CCODa3crcCCO(raOCOCCa3CCa3a2[DCf:cC. n^cCCDCDCC cDccaccD CClcCrDCDCCCCCO 

l-H ^ H-i hi — 4 h — 4 ^4 •— 4 ^4 »— 4 h -4 »— 4 4 h — 4 h — 4 ^-4 1 -^ »-H 4—4 ^ h — 4 h — 4 1—4 b— < 



«IC<l<t<l<l<i<i< 


<-^<<i<i<;«a<<.<i<<ic<t<<^<i'‘a<<i<a<i<i<<j:<«i<i<q.<i<a<j<<.< 


o 

_J 

< 

oc 

UJ 

h~ 

< 

iJJ 

o 

CJ 


o 

't 


o 

h- 

o 


•n 


o 


<I 

h- 


•3 

aJ 

r^ ijj • 

•n 3 ,x. 

^ H- 

c:: :/) 

h- h- -J 

-i: 

Q U U- 
O O *-• 


+ 

<i 


n M 


X -X 

XI <: 


H- 

X 

OJ 

'^. 

-4. O 

h- o 
X ^ 

l;J 

o 

ijJ 

3 U 

■'XJ 

«rX 

O h- .IC 
•3 •» < 

r — 4 f— 


o m ui 
O <T O 
^ \- « 
< ^ h- 
h“ 1 ^ X 

c/^ X Ji 
3 1.1 

• a + 

H- r.) >- 
o <r X 

M (J 

h- — 4 .J *-* 

X < 3 ^ 

.jj 4 £! u- <J u. 

O — 


O 

II 


:nj 

U4 

O. 

<l 


O 


3 


1— 



• 






'-0 



X 



3 



u 






O' 

• 


ir 



u. 

c\i 


X 




UJ 


3 




X 


I— 



iU 

<T. 


X 



X 

h- 


UJ 


o 

<l 





OJ 

1— 



i.^ 




3 


IxJ 


3 

«x 



s_. 


V— 

3 

O- 


X 






oo 


13 

-0 

O 




o 

3 

u» 


J~ 



<I 

h- 


<1 


h- 

4^: 

•3 


;/) 


X 

i-t. 

,.i 


X 



Iv 

3 


3 


X 

1— 

' 4< 

.IJ 



« 

X 

s/0 

3 

.u 

»-H 

h- 

I'J 


;<T 

UJ 

+ 



OO 

»— 

^^ > 

X 

« 

> 

3 

K- 

3‘ 



••u 



It 

II 

>— • 


.— • 

3 

X 


3 

.-4 

I- 

O 

:.' U 

X 

►-4 


3 


o 




O 


X 



•yi 

..u 

O 

•—4 

o 






f-H 



tj 

13 -• 

3 3 l_> 




c\j 

i.U 

IX 

<I 


o'> 

uu 




X 

iU 


.“D 

U 


X 

OJ 

o 

o 

<r 


:£l 

+ 

•CC 


<1 




vO 

3 



1-4 


K" 

3 

»— 


3 

3 



— 



“0 


11 

<a 




>■; 


+ 

• 

.... 


3 




.3 

O 

.'M 

i — 


“5 


w 

U.‘ 

■‘■i 

(.X 

*%! 

t- 

3 



3| 

or: 


D 

3 


—4 

• 

J 



3 

'7-^ 


3 



Oj 

.> 

.•n 

>. 

•;< 

...^ 

;3 

fc-» 

'.J 

II 

“5 

3 

•3 

UI^ 

IU 

1— 

H* 


r- 


w 



h~ 

w> 



II 


3 

3 

X 

’.J 


3 

O 

'3 


3 


•JJ 

U- 


<\4 


•3 3 O 


3 '.n 


•IM 

m 

rn 


r- 



CM 

rq 


rsi 

.n 

O 

•D 

O 

»3 

cq 

o 


q 

nT 

r- 

OJ 

rq 

3 

;q 

13 

■0 

>r 

vT 

>r 

4* 

3“ 


u> 

u> 


sO 

3 

'O 

r«- 


• 

r«- 

r- 

>- 

r«b 

'3 

3 

■J 

—4 



OJ 

‘NJ 

vNi 


•M 

r-A 


•3 

— J 

i3 

t—M 

M' 4 

^“4 



3 

r-^ 

F 4 


•«H 

-4 

■— H 

c\i 

f\J 

OJ 

OJ 

OJ 

OJ 

(M 

OJ 

OJ 

o 

o 

o 

o 

o 

o 

o 

O 

O 

o 

O 

3 

o 

3 

3 

3 

3 

3 

3 

O 

O 

O 

O 

O 

O 

o 

o 

O 

o 

o 

o 

o 

o 

o 

3 

o 

O 

3 

O 

3 

3 

3 

3 

CU 

3 

3 

'3 

3 

3 

3 

3 

o 

O 

o 


3 

o 

o 

o 

o 

o 

o 

3 

o 

o 

O 

o 

O 

O 

O 

3 

O 

O 

O 

3 

3 

O 

3 

3 

3 

3 

o 

3 

3 


12 



CCCCCCCCCCODCCCCCDCCCOCDCCCCCOCCCC fljODtDcLCGajCCcC/ECCCDCDCDCDCCCCa^CC OJCC- CDCCCCcCCCCCiCD 

»xi HH t.—| »->• H-4 *— 4 l~4 (—1 V>-l »>«<* ^4 ^ »— 4 »->4 K>4 H~l 4—4 k>H M |»( 

l-J-J-J— l-J l-J— »-J_J-J-J-J_J-J-J_J_l-J-Jj-J-i 

<<<<i<t<t<<i<t<<i<<i<i:<i<r< <i<i<<<a<<i<i<«:t<<i<i<<<<i< <1<<IC<<<<< 


Cl, 

oO 

CJ 


3 w 
O LL» 


(,D 

to 

to 

ni 

<w> 


2 f 

< 

O 

s 


o 


cn 

o 

o 




ro 

a 


0 


c- 

X) 

0 

— i. 


)JJ 

a: 


oc. 


0 

0 


K 


Q- 

(1 




0 

0 

•:d 

X 


< 





0 

0 

0 

tL) 


H- 

j— 

• 

t— 


0 

0 • - 






0 




0 




u 

a 

0 ^ 

»— * 

00 

0 

0 

r«*. 

oO 

0 

H- 

^- 


0 

Q 


r^ 

r- 

iU »- 

0 


D 

tJ 

X 

X 


f^ 


^ X 

f^ 

M 

a 

a 


0 

r— 

r- 

r*' 

!.U 


UJ 


<xL 

>• 

3 UJ 


,s. 

r>». 

H> »— • 

a 

a 




X 


h- 

p»* 


U. 


LJ 














u 








• — 

0 


CO 





CO 

CD 

0 


>. 




U 





ii: 



—1 



uO 

c: 



;>• 


rO 


m 



i'^ 

A 

■D 

< 



LJ 




4—4 


3 

0 


4-4 



X 


L/» 


LL 





31 


31 



r*- 

31 

oO 

1— 

CO 


If. 



0 



<r 

'T 

4- 

a 



i- 


< 

0 




l'^ 

1'^ 




CO 





*. 

< 


IL 



0 

< 


31 

CM 

CM 

0 . 



u 



Ui^ 

to 

» 


)'«• 

' - 

0 


Q 

3- 


• 

0 

O. 

— * 

h- 





CM 

a. 

aj 







LJ 


>-4 

<LI 

4-4 





1— 


►- 

r-. 


0 

1“ 

U 

4—1 



C2 




X 

r- 

LJ 

tJ 

LJ 


L/» 




Lj 

LJ 


LJ 



1 '• 









w 

*— • 


lU 



LJ 

LJ 

• 


1— 

1 — 

ci 

4£l 


LJ 


LL 

< 

l-’J 

■— 4 


• 

• 

LJ 


LJ 

• 


< 

LJ 

O’! 

UJ- 

_l 


^— 



h- 

lU 

LJ 




f— 

LJ 





•u 

0 

>_ 


f.j 

t:.) 

'X 


L'-> 

f'_-4 


• 

LJ 


-J 

• 


0 






LJ 

Cl 



>— 4 


<l 

« 




X 









—4 


< 

CO 

;u 


x« 



U 

4—4 

<L 

to 

to 

0 

X 

1— 



ou 

4— « 

a 

LJ 

X 


c 

< 




<*. 


3J 



< 



-J 

X 


0 


f 





X 

< 

< 

«M 


1— 




• 

• 

rn 


0 

• 

< 1 

+ 


JC 


• 



CM 




— » 

— * 

— • 

— *i 

»— < 

f J 

1 

4— 

»“ ■ 4 

_l 


f 

tn 




< 


0 


X 


f*-vl 

:.U 




00 




LJ 

fH 

0 


•3 

tJ 


< 

< 


J 

■3 


tO 


4-4 

>• 

1— 



> 

>4 

>• 

4-4 


t— 

xK. 



» 


r— 

^— 



• 

• 

• 

• c 

u 

i_j 


•X 


LX 


t »j 



>- 




>• 

J- 

— • 

• 

X 

X 

..u 


i>0 

31 


ty* 

0 

! U 



LJ 


-■i. 



U 


LJ 

.< 

<x 


■Li 

4-4 

« 


• 

4-4 

•~4 

— 


«-iu 

LI 


0 


— 


-j 

• u 

-J 

ii.1 

XI 

X 


h" 

X 

S-.4 



•^: 

3 

LJ 


X 


-••■> 

'.M 

t— -A 

— ■ 

•— 

r- 



0 

+ 

r-*4 


a 


• 

-J 


• 

• 

• 

c 


r— 

r— 


X 

• *j 

X 

C 


•?G 

1 — 

•u 

+ 

LJ 'O 


K— 

CO 

• 

> 

X 

h- 


1— • 

•yO 

c 

1— 

i U 

<n 


:o 

,.C 


tO 

--4 

—1 

■U 

C 

:i. 

X 



< 

to 

» 

> 

• -:m 

CO 

CO 

—H 

CT' 

X 

< 

X 


) — 

..D 

.’<r 

0 

lO 

►— 

*'-T 

< 

<l 

LyO 

<x 

:.f' 

:;t: 

to 



•3 



1— 

4—4 

■vj 

> 

>• 

►-S 


X 


•J^ 


:) 

0 

3 


—4 

t 


II 

1— 

K- 

r* 

»-4 

.'Z 

..'i 

.2 

0 

: II 

:< 

X 

X 

— J 

n 

X 

fj 

4— J 

>• O 

X 

X 

(1 

X 

H- 4 

-J 

►--« 

H- 

3 

_J 


K-4 

> 

3 J 


5" 




II 

II 


i/> 

LJ 


iX 

If 

X' 

M 

4-4 

II 

4 — t V— 

II 

M 

•X 

5C 

h” 

-J 



X 

_J 

II 


rx 

<1 

■ — • 


w 

•—* 

w 

.ri 

3:. 

4-4 

XJ 

-J 

u 

yi: 

>- 

< 



>- 



vO 

<.r 


< 

< 

X 

0 


'-5 


‘-t- 

0 

h“ 

LX 

■X 

X 

0 

'3 


sO 

0 

X 

-J 

X 

c 

y- 

h- 

'M 

X 

> 

X 0 

X 


( — 

X 

00 

0 

-4 

0 

> 

lJ 


4-4 

0 

•"X 

-4 



:< 



CM 

rx 

1— 

r 3 

h- 

X 

— * 




4—4 

4-4 0 

4 -. 

X 


4-1 





X 

0 

0 




0 















lA 




0 








'O 

-;:3 




•M 














.3 

3 




m 





0 




.%j 


0 


‘M 














31 

31 




31 





>r 































it 




0 L-) 0 



-M ^ 5 - 

^ -«• 







-a- 

* «■ 

a- a- 

^ -W- -a 

-K- > 


■a * 












■0 

CsJ 

.A 


'0 

0 

CM 


-0 

•“H 

’M 

M- 










-0 


CM '•r^ 


0 3 

(A 

0 

!'X 4 



r\j 

n) 

m 


A 


>T 


•>r 

U \ 

J■^ 











A 

U"^ 

X 

VU 

X 


r* 



X 


rvj 

CM 

CM 


CM 

CM 

3 ) 


CM 

CM 

CM 

(M 










CM 

•34 

31 31 

31 

31 3 J 

31 

3 J 

=M 

A 


0 

0 

0 


0 

0 

0 


0 

0 

0 

0 










0 

0 

0 0 

0 

0 0 

0 

0 

X 

J 


0 

<LJ 

0 


0 

0 

0 


0 

tj 

0 

0 










0 

LJ 

0 0 

cx 

LJ 0 

0 

X 

0 

0 


0 

0 

0 


0 

3 

0 


0 

•sO 

0 

3 










0 

0 

0 0 0 

0 0 

0 

0 

0 

0 


13 



CJ 2 CC CC ca CD CC CG 



h-* K- k- 

^ ^ ^ ^ ^ ^ 

<i < <1 < <t <r <i 


or. cc cc cT; oc 00 q: cc CD cc CD- cr- cc CO CD or. co. cr- a./ co cr;- ci3 co a', oc cc co oc ctd cT; oc cCi oc cc rT; 

»— 4 k— 4 h.H *— 4 ^_4 ^4 *— « ‘—4 >>-4 ^ 4—4 4—4 »_4 4—4 k— < »— 4 4— « 4—4 4—4 4—4 k— • 4- 4 k>X 4-^ 4- 4 4-^ 4—4 


V-K-J— V— h~ I— 


K- ) — V — h- k- H- 


c<L<i<<r<i<i<.<i<i<i<i<<ic<i<<i<i<<x<i<i<i<<<i<i<i<i.<<i<<i<i< 



• 


o 


Ui 




cc 


ro 


o 




►- 


O 


Ln 


h— 


cx: 




4.U 


C3 

>• 

> 


O 

< 

o 



_J 

• 



> u. 

-tf 

• 

— * 

<I U.I 

CJ 

• 


-J > 

*--4 O 

• 

• 

rtf LJ 

1- > 

V 


:.Li 

< <l 

-J 

itj 


> >- 












0 

Ctf 


5. 







Ctf 

0 

> 

<1 













Cf) 



a 






« 






< 


<r 



1 




0 1- 

-J 

t— ( 













M 



<r 






J£ 






5.' 


«JC 



a 




a. 



»— 













• 



K 






Q 





•—• 

4—4 


0 



o 




X 

u- 

<. 

4-4 













id: 



5 : 











< 

Ctf 


'-J 







*-4 

•'.tf 

■— * 














3 



«—» 






u. 






CL 


oi 



1— 





to 


►— 













t 



• 






:t 








a 



oO 




>• 

•— « 

*-4 

• 













— % 



3 






UJ 





> 

> 





<r 




ctf 

JX 


» 













> 



3 






> 





CJ 



to 







< 


»— » 

• 













—4 



■5 






O 








4-4 



w 




:tf 

3 


JJ 
















* 









— <4 


CD 

Q 





vU 




rc 

J-- 

di 

X 












D 

L* 3 









iU 



2 : 


lU 

UJ 


H- 



-J 




4—4 


h- 

a 













X 



fM 


Ctf 







zt 


1— 

t— 





D 




_l 

;?r 

to 

<1 













or- 



• 


•— « 




'TD 



4—4 


■-i 

0 


oc 



•t 





LJ 

-J 

h- 












•- 

<1 



.' .■ 






<T 



*• 


‘•J 

iU 

LJ 

0 


0> 





X 

>-4 














■H 

V- 





o 




»— 





-j 

J 

<U 

a 


•0 





X 

\— 

‘X 













•3 

II 


3 

• 











lU 

:U 

L- 



m 

3 




0 

— • 

a 

1—4 













—4 

a 


•a 


_j 




X 



II 


to 

(-0 

Ui 

21 



H" 





tO 










— • 





>- 



0 






UJ 







txJ 

LJ 


u 





3 


< 








a; 

>- 




— • 

4-4 

—4 


— * 


u. 

■— 4. 



o 




— 

;!J 

lU 

-J 

t — 4 


u- 

lU 




X 

u. 

‘-J 

X 







CJ 





'U 


* 

X 



_? 

o 






_} 

0 



UJ 

i— 



r“ 






—4 

-H 













1 tr 

CD 

r- 

• 


a) 

4>: 



4-4 



rr.j 



*— • 

to 

U 


UJ 

»/* 





k— 


I 







U) 

*— 




• 

X 

< 


LJ 









» 

-J 

t— 

H- 


: U 


Ui 

_i 



4— J 

4—1 

OO 

r— • 

4-M 







_i 

■-ij 




C'2 

X 

■4. 

U.4 



.itf 

«k 








13 

J> 

I— 

-J 






4 . 

-•1 

<t 

to 

u> 







* 

X 




2. 

*-a 

• 

0 

<T 


ID 

U- 



o 



D 

U- 

0 

0 

a 

•i.1 



0 



•a 

h- 

X 

0 

•3 







X 

X 





u- 



f 


-J 

3 



rn 



—1 

rD 

r< 


itf 

00 


T' 




<3 



a 

a. 







<T 

’TT. 




• 


>- 


—4 



CO 




-J 



CO 





4—4 



4-U 


i— ■ 

a 

2:. 






X 


—i 

1— 

u- 





— 

4 — « 

v*'! 

•M 


ty> 







«✓! 



S/J 

to 

u> 

’W 

• 

— i 

"¥ 


to 

LJ 

tJ 






—4 


1 

t/J 

II 




y>- 

X 

— 

« 

• 

CO 

i: 




i:tf 

It 

cu 

a: 

m 

•J 

'll 

MJ 

•iJ 

5 : 

C3 

+ 

< 

ca 

— J 


X 

to 

LJ 




1 


CL,> 

—I 

— • 




4-4 

• 

• U 

c? 

4^.1 

■u 

CJ 


OsJ 

■0 


l-J 

•-U 

a 

w 

e- 

f— 

f— 

1— 

UJ a 

;.i.i 


1— 

1— 

1 

a 

o. 

«u 

*3 




X 



II 


—4 

— < 



^ 4 

_J 

■J i 



<1 

a 

+ 


'S. 


rvi 

-ri 

u 

<1 

•^I 

'4. 

<l 

Ctf — « 

• 


UO 

00 

x> 

i— 


X 

•4* 




?! 

a 

h- 

"J 

rvj 

1 

1 


‘ 'J 

V J 

C 

• 

• 

n 

•--U 

o 

>- 

CM 

UJ 

a 

II 

• M 

0 

0 


LJ 

LJ 

LJ :M 

2Z 

«o 

--J 

_j 

•LJ 


.0 






L- 

h— 



• .4 

*'< 

V 


X 

• 

<r 

■Q 

'ft 

—4 

■:C 

■■< 

>. 


■:c 



Li: 

X 

4 -^ 

*-« 

4—4 

1—4 


J 

_J 

II 

II 

1— 

J 

h-. 

to 

L3 




JL 

to 

-H 

•3 



■>» 


X 

-.-T 

i— 

■< 

(,;i 

■n 



«— 4 

w 






CD 

a 

tJ 

03 

CJ 

n 


■.a 

'.C 




>— 4 

►— * 




r-4 

X 

X 

M 

J 

*—4 

— 4 

■*NJ 

'J 

-J 

II 

k— 

•-* 

•w 

-J 

-J 

II 

h- 

J 


— 

-J 

_l 

i: 



2: 

h- 


• u 


X- 


iL: 

• tfi 

II 

II 




X 

II 

II 

•3 

X 

II 

II 

4— 

h- 

—4 

a 

X 


O 

-J 

-J 

>- 


-J 

-J 


..J 

-1 

4—1 

4-^ 

4— < 

.-H 

II 

w 

> 

I— 

h- 

II 

> 

> 

J- 





II 

>■ 

fvj 


t:J 

I'M 

>• 

II 

— 


•'1 

— 



<L 

<T. 

>• 

LD 


<3. 



< 





:_j 

u. 

3' 

1/1 

to 

•< 

•3 

Ui 

J- 






>• 

N-- 

I'J 

<‘1 

"vj 

J- 

•>- 

X 

X 

1 — 

•L 

iX 


CJ 

O 


6 

o 

Ui 

U 


0 

fs„ 

rO 


rU 

4-< ( ^ 


T. 

_j 

X 

*— 

s: 

— 

v-4 





4>U 

—4 


0 


4—4 



4-4 

.-4 


— 

4-« 






:0 


r- 








0 


















3 


fM 

#■ J 









rO 










Ui 


















M 



3 









^vj 


CM 







0 

rn 




















rO 

-0 




























* 

* 

■ih 'W- 
























« 

•j;- 



CM 







>J- 

-> 


> 

■» 

* 















0 

•r 


'M 

4 - 

4 - 

•0 

f *44 



f^ 

(M 

CM 

0 

0 

M 


'J' X 

1 "^ 

<M 

rO 

Nv 

0 

.-a 


'.M 

4 - 

0 

CJ 

LJ 





-u 

fM 

•M 

CM 

‘'«3 

f*l 

o > ro 

>r 

nT 

-T 

^^ 'T 

>r 

u> 

U> 


u 

X 

X 

i'-* 

r^. 

.3 

ra 

m 

cr) 

01 

r»i 

(▼1 



i-n 

rn 

r«) 


ro ro 

fO 



m r«i 

fO 

m 

ro 

•r »3 

ra 

fO 

3 

c(^ 

ro 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 0 

0 

0 

-Ui 

0 0 

X 

0 

0 

(X 

0 

3 

X 

tJ 

X 

0 

0 

0 

0 

<x 

0 

UJ 

0 

0 

0 

0 

vJ 

CX 

0 0 

0 

0 

X 

X X 

0 

X 

:X 

X 

X 

LJ 

X 

X 

X 

0 

0 

0 

0 

0 

0 

0 

0 

0 

'•.X 

rx 

0 

0 

0 'X 

0 

0 

3 

0 0 

0 

• J 

X 

0 

0 

0 

••-J 

r .3 

0 


14 





cccocDtEjccDcccocccccccccccDcccrjcfjrricrcriCijcncQcE 

¥—* |-~4 »— I »— H »*-< •— < »^» *-H *— » »— •-« 

— »— l-J-J-J— J-J— »— l-l-J-J— »-J— l-J_J-J-J-J_J— l-J—I 
h“H"^-K-h h-k-h— H-V— K-h H* 

<<i<a.<i<<t<r-cx<<t<x<':t<<<.<<t<<x<<<t< 


•'C 


o 

o 

o 

m »sj 

O r^ 

r<^ r> 


o 

f^ 






















h- 

fs« 























r«- 






















c 

>. 






















cr> 

rs* 





























JC 

















h- 























r^ 






3 

















r«* 






Ll 
















• 

r>- 




fM 


-X 







o 


GQ 







‘.U 



OJ 


3 


-.IJ 







r»i 


nO 







2T 

• 


f^ 




> 









«— 4 







• 

a 


• 




u 







rj 


II 










lY. 


O 









t— 


— • 







o 

<i 


o 


1— 


XI 









ro 







»-4 

• 


• 




-J 




o 



CJ 


— 







— 

— 




u 


rjj 




rn 



VLI 


u; 







• 

>- 


>- 


•-D 


<2 






VL> 




o 






o 



•— • 




*— 




t_J 



— * 


_i 








W 


—' 








►— 



CtJ 



..J 






<1 

'.iJ 


IIJ 


Tj 


T-- 


— * 




» 




*■ 



F-* 



• 



3 


•< 


o 


rtO 

vC 

o 

rc^ 

LX 

r- 



LX 


ca 

1) 




C.J 


O 

— • 

i.. 




n 

rvj 

o 

r\i 

3 



• 

3 


nO 

'M 




c 


<T. 

>- 

•2. 


—4 

_' 




a > 

c; 







A\ 



t 

h— 


K- 

»— * 

1— « 




»• 

» 

— « 

•> 

• 



•jJ 

*■ 






rji 

It 


It 


3 


■X. 

iX. 

("O 



•— 4 

rO 

• 

•■c 

« 

—4 

_4 

F— 4 

—4 



Li 

— 

3 

— • 

>z 

• 


'X 

w 



• 

•w 

'««■ 

■:j 

o 



J 

•— 

w 



• 



>- 

lu 

l~ 



4Sl 

X 

a 


a 


lU 

<\l 

f\j 

o 


X 

a 

• u 


< 

►-H 

.3 

»— 1 

.::c 

3 


<;J 

rj 

?/) 

v^ 

..J 

oo 

O 

• 

II 

w 



<0 

t.O 

3 


o 

— * 


w 

O 

• 


•X 

< 


-•.o 

• 

-t> 

oc 


— • 

LD 



r 

00 

>** 

-y 

)— 4 

■u 

a 

<U 


> 

3 





00 



'iiC 




CJ 




■iC 

w 


t- 


1-^ 


I— 



-i 


-J 



-J 

>— 


_l 

H- 



I— 

3 


:i: 


.;d 

II 

w 


.-J 


-J 

-J 




■W. 

':T- 




— 1 

-1 


►- (3 

LL 


o 

< 

>- 

U_ 

U 


<T 

< 


J. 



IX 


LX 

< 

3 


•4. 

•3 

jtj 5: 

1-4 


o 

h- 



3 

'O 

O 


o 


o 




— 

•J 



O 

o 

jC u.] 




un 

3 





3 










-r 


03 





3 






O 










X) 


nO 





•m 




3 






m 






<-a 





r«- 


r^-sOO.-^'J*'^-4fM>f.nr^— 4rNj-t'r-p-^r<>-4J^r\J4*>Ov3Cj 
— 4 c\i r>j -.Nj 'Ni .-r> rr) m m ^ -T 'T -x> isy n o >u -o 'U -w f^ 

>T'sr T^r'^^^'rvr^^>^■'r'^''r<r'3■^f>^>^’'T'r't 

o :? o :3 o o o o o o o o o o o o o o o o o o o 

o o o :? .j o o o o o o o o o o o o o o c? o ^ 

O O O O O .0 O O O ^ 3 O 3 3 3 o o O O O 3 O O 3 


15 



Subprogram RDECK 

RDECK is a FORTRAN function. Its parameters are the logical unit number (LUN) 
to be used and a position in TABLE to begin storing data. The primary job of RDECK is 
to compose a table of PIDL, ENTR, and LINK names. This procedure starts with a call 
to RCI to read one logical record. If this record is from FILEl, it is output on FILES. 

If it is from FILE2, it is written on the RANDOM ACCESS FILE. A flag is then made of 
the code number and word count for the first table in this logical record. A slight 
digression might be in order here. The deck of a subprogram as it is output from 
COMPASS/FORTRAN and most other language translators comprises one logical record. 
Each record consists of a number of tables. Each table is preceded by an identification 
word which specifies to the loader the procedure to follow in loading the table. The iden- 
tification word has the following format: 


CN 


WC 


LR 

L 


59 53 47 35 26 17 0 

CN — Code number identifying type of data in table (PIDL, ENTR, LINK, etc.) 

WC - Word count in table (excluding identification word) 

LR - Method of relocation for the load address 
L — Load address 

The code number (CN) identifies for RDECK the three tables of interest in each 
logical record: a CN of 34 identifies the PIDL table, a CN of 36 identifies the ENTR 
table, and a CN of 44 identifies the LINK table. 

The LINK entries are also commonly called externals. As they are gathered 
together by RDECK, these names are put in a table with the following structure for each 
logical record: 

(1) PIDL name 

(2) Number of entries 

(3) Number of externals 

(4) ENTR names 

(5) LINK names 

The word count (WC) is used to index through this logical record from one table to 
the next. Control is returned to ALTLIB after each logical record is searched with a 
true condition set. A false condition is set if an EOF has been sensed. 
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RDECK checks for overlay records and segmentation records. When they are read, 
they are written onto the output file (FILE3). RDECK then reads the next logical record. 

An RDECK flow chart is presented in figure 5, and the subprogram listing follows. 



Figure 5.- RDECK flow chart. 
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Subprogram RCI 


RCI is a COMPASS subprogram that initiates all file action requests for the 
ALTLIB program, except those for the RANDOM ACCESS FILE. RCI calls the Circular 
Input/Output (CIO) subprograms to complete the file action requests. To carry out its 
purpose, RCI has three entry points: 

(1) Entry point RCI is for reading information into the common buffer BUF. CIO 
issues a binary read function code 12B, the B indicating octal representation. The 
parameters for this entry point are LUN, which is the logical unit number; BUF, which 

is the first word address of the buffer for data read; and LNG, which will contain the num- 
ber of central memory words read and indicate whether the read is complete. 

(2) Entry point WCO is for writing data from the common buffer BUF. Its param- 
eters are the same as those for RCI except that LNG is a three-element array. LNG(l) 
is length if LNG(3) = 0. LNG(2) is 1 or 0 depending on whether or not the write is com- 
plete. LNG(3) is equal to 0 if no End-of-File is detected or is equal to 1 if an End-of- 
File is detected. LNG also contains the CIO write function codes (16B or 26B). A 16B 
code writes full PRU's. A 26B code writes available information terminated by short- or 
zero-length record to indicate End-of-Record. (See ref. 1, p. 3-29.) 

(3) Entry point BSP is for the file action requests for BACKSPACE, REWIND, and 
WRITE EOF. Its parameters are LUN, which is the logical unit number, and LAC, which 
is the file action code to be used. 

An RCI listing follows. 
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ENTRY RCI ALTLIB 

2203UOOCCCOOOCOC1'^4 NAME VFD 42/ OLRC I , 18 / 100 ' ALTLIB 

* ALTLIB 

* INPUT ROUTINE ALTLIB 

* CALL RCKLUN.BUFfLNG) ALTLIB 
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Subprogram lOVLN 


lOVLN is a COMPASS function that decodes an overlay identification record. The 
parameter passed to lOVLN is the first word address of the overlay record. lOVLN 
returns the following information to the calling program; 

lOVLN = 0 indicates a main overlay record decoded. 
lOVLN = 1 indicates a primary overlay record decoded. 
lOVLN = 2 indicates a secondary overlay record decoded. 

An lOVLN listing follows. 
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Subprogram INCREM 


INCREM is a FORTRAN function that calculates the TABLE location where the next 
PIDL name will be stored. INCREM is equal to the present index + 3 + number of entries 
for the last logical record + number of links (externals) for the last logical record. The 
parameter passed to INCREM is the present PEDL name location. 

An INCREM listing is presented on the opposite page. 
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Subprogram ADDEXT 


ADDEXT is a FORTRAN subprogram. Its parameters are TABLE (I), TABLE 
(lEXT), and NEXT. TABLE (I) is a location in TABLE that specifies the beginning of a 
list of EXTERNALS to be operated on. TABLE (lEXT) specifies a position in TABLE 
where a list of EXTERNALS will be stored. NEXT is the number of externals found. The 
purpose of ADDEXT is to make a unique list of all externals to be satisfied and mark sub- 
programs as selected for subsequent merging with the user's binary program file. A call 
to ADDEXT is made only when the user program needs this subprogram. When ADDEXT 
is called, it puts a 1-bit in the rightmost position of the PIDL name entry. ADDEXT then 
searches the list of EXTERNALS for this subprogram. If there are any externals that 
are not on the Ust of TABLE from TABLE (lEXT) to TABLE (lEXT + NEXT), these exter- 
nals are added to the list and next incremented by the number found. The list is composed 
from the user's binary file program and selected subprograms. 

An ADDEXT listing is presented on the opposite page. 
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Subprogram CHARS 


CHARS is a FORTRAN subprogram that was written as an interface to subprogram 
STRING. This subprogram is needed to position words of the LINK table properly. LINK 
table names can be split between two words in the following manner: 


LINK name Q8ENTRY 


Word 1 
Word 2 







Q 

8 

1 

E 


T 


R 

Y 










CHARS puts them into one word (B) in the following format: 


B = 


Q 

8 

E 

N 

T 

R 

Y 





The parameters for CHARS are A, B, I, J, and N. A is the first word address of 
the array from which data are removed. B is the first word address of the array to which 
data are moved. I is the byte position in A from which the first byte is moved. J is the 
byte position in B to which the first byte is moved. N is the number of bytes to be moved. 

CHARS is written in a general form, but for the present purpose I is always of the 
form 1, 6, 11, 16, 26, . . ., 5(n-l) + 1, . . .; J = 1; and N = 10. 

A CHARS listing is presented on the opposite page. 
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Subprogram STRING 

STRING is a COMPASS subprogram that moves a string of N bits. The first bit 
moved is the Ith bit of A. It is moved to array B starting at the Jth bit. I and J are in 
the range 1 to 60. STRING is written in a general form, but for this problem, N = 60, 

J = 1, and I = 1 to 31. 

The parameters are A, B, I, J, and N. A is the first word address of the array 
from which data are removed. B is the first word address of the array to which data are 
moved. I is the bit position in A from which the first bit is moved. J is the bit position 
in B to which the first bit is moved. N is the number of bits to be moved. 

A STRING listing follows. 
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Subprogram EXOR 


EXOR is a COMPASS function that performs an exclusive OR between the two items 
specified in the parameter list. EXOR is equal to the result of the exclusive OR. 

An EXOR listing is presented on the next page. 
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Subprogram WORDS 


WORDS is a COMPASS subprogram used to check and set default parameters of the 
program call card (control card for ALTLIB operation). This task is accomplished by a 
check of information in RA + 70 to RA + 77. An example of the control card for 
ALTLIB is ALTLIB (LGO, TAPEX, TAPEY). LGO is the user's binary program file. 
TAPEX is the alternate library file. TAPEY is the object load file. 

The default parameters for this card are as follows: LGO for user's file, BNFILE 
for library file, and LGO for object file (user's file and selected subprograms). WORDS 
has one parameter, LLGO. LLGO is set at 0 if the object load file will not be the user's 
file, and it is set at 1 if they are to be the same. 

The following are examples of acceptable variations of the ALTLIB control card; 

ALTLIB. 

ALTUB (LGO) 

ALTLIB (LGO, BNFILE) 

ALTUB (,TAPEX,) 

ALTLIB (,TAPEX, TAPEY) 

ALTUB („TAPEY) 

ALTUB (LGO„LGO) 

ALTUB (LGO, TAPEX, LGO) 

ALTLIB (LGO, TAPEX,) 

ALTLIB (LGO, BNFILE, LGO) 

A WORDS listing is presented next. 
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Subprogram CRE 


CRE is a COMPASS subprogram that creates the File Environment Tables used in 
ALTLIB, The File Environment Tables are created to facilitate the use of a common 
data buffer for all files and to use less storage. All four files that are created by CRE 
have the same buffer area BUF. 

A CRE listing follows. 
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Subprogram ILSHFT 


ILSHFT is a function written in COMPASS. Its parameters are BUF and N. BUF 
is a word that is shifted N bit positions in a left circular direction. ILSHFT is used as a 
positioning technique prior to masking. 

An ILSHFT listing is presented on the opposite page. 


48 


cPcccDcoccccecec-cccccotcflCco 



«I<^<<<^<<f<<<<'< 


VO 

UJ 













o 











CO 

z 




X. 







u 

LU 




K 







o 

oc 



< 

•— • 







CO 

UJ 











X 

X 






■h- 





>* 

LU 




> 


2 





to 

cc 















<x 

_j 


O 






m 



h- 

< 


o 









<I 

X 











Q 

or 


>- 










u 


Ul 









►— 

z 


•— • 









Z) 



X 


L— 







CL 

u 


i/} 


u. 

u 







UJ 



>— 

b-4 

Z) 






o 

oo 


u. 

Z 

X 

CO 


to 




h- 

3 


o 

3 

to 

UJ 


K 








O 


QC 


z 




t- 

CO 


CO 

o o 



UJ 

to 



u. 

•t* 


to 


K 

00 


X 

Q 



►“t 



LU 

H- 




UJ 

Z 



X 



QC 

u. 

a 

X 


H- 

CJ 



00 



o 


QC 



<1 

o 






L3 

X 

o 

•o 


0“ 

LU 



a: 

• 


< 

VJ 

X 

X 


oo 

to 



< 

Z 












o 








O 



D 












O 

H- 













• 







• 



»i-* 

ui Z 







o 



O 

a 

O 








H* 

►- 


Li. 

1— 1 








u. 

LL 

fi-' 


►- 




fN» 

u. 



X 

X 

u. 

Q 

<i 




X 

X 



VO 

oo 

LU 

tu 

QC 




► 

oo 







LU 

rg 

«u 

1-4 

00 

-J 



»-4 



u. 

a. 

O CD 

X 

CO 

CD 






<I 

•—* 

o 









»- >• 

to 

to 

o 



z o: 



z 

<t 


UJ H* 


■*0 


h— 


O 2 

h- 


X 

<1 

< 

*-» LU 

a 

w 

to 

o 

CO 


X 

X 

<t 




oo 

o 





u 






^ cC <. h- 

u. 
X 
</) 




ro pj ^o O >• 

CD <l X CJ ^ C-3 -J 

(/) LO UJ LLl UJ CO 

VO X 
_J UJ 
(/> 
LU </) 

o < 
< 

£X O 

o o • 

H' 'T 

VO <4J 


O 




og 


O 

CJ 




o» 


3 

o 




>u 


CO 

o 




r>j 



c:; 




vNj 


fO 

o 



o 




o 







o 



CM 




o 



O 


♦ 


o 



u> 




o 


o 



O 


o 





CJ 


o 


ro 



o 


o 


TL 



o 


o 





■o 


o 

o 




3 


o 

rg 




o 


o 

>u 




o 


o 

4J 




'J* 


o 

JO 




o 


o 





rg fO 



49 


PROGRAM USAGE . 

Requirements and Performance - ^ . • 

The program ALTLIB requires 37 400g central memory words of storage. 

On the Control Data series 6600 computer.system, ALTLIB uses 15 to 60 seconds 
of elapsed time for most jobs. The following time summary, is taken from jobs used in 
the development of ALTLIB and can be used as a guide to expected performance: 


Parameter 

Case 1 

Case 2 

Case 3 

Number of overlays in job 

6 

22 

B 

Number of subprograms in library 

*11 

*11 


Elapsed time, sec 

25 

44 

■■ 


*The length of some of these subprograms was above average ^SOOOg to 
30 OOOg central memory wordsj. ; . 


Control -Card’ Operation 

The program ALTLIB is called into operation by a control card. The control card 
has three parameters: the’ user's binary. file, the alternate library file, and the object 
load file (user's program and selected subprograms). The default values forithese 
parameters are LGO, BNFILE, and LGO, respectively. The accepted delimiters for the 
AL'TLIB card are standard SCOPE, delimiters. 

The following are acceptable forms of control-card calls: 

'' ALTLIB;. *.• : ■ 

- ^ALTLIBi (LGO) ' ^ . 

ALTLIB (LGO, BNFILE) - 
ALTLIB (, BNFILE) ' • ■ 

ALTLIB. (LGO,,) . !■ . .... .w 

ALTLIB, (,TAPEX,) 

ALTLIB (,TAPEX, TAPEY) 

’ ' ALTLIB („TAPEY) ' 

' " ' AtTLIB (Lg6,,LGO) ■ 

ALT LIB (LGO , TAPEX , LGOV 

iALTLIB.(LGO; TAPEX,) ■ . ■ ' : >■ / ^ 

.. u ALTLIB (LGO, BNFILE, LGO) r 
, . ; ‘/ALTLIB (LGO'; TAPEX, TAPEY) 
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The following sample demonstrates the use of ALTLIB as it might appear with a 
group of control cards; 

JOB, 1,200,60000. P0008 , 90930 

USER, DROZDOWSKI, JOSEPH M. 

RUN(S) ' ‘ ■ '■ 

FETCH (P0094,SPRA01, BINARY) '• • : .. 

ALTLIB (LGO, BNFILE, LGO) : 

SETINDF. • . , / • 

LGO. 

EXIT. > - 

DMP(FL) i 
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Error Messages 


Messages indicating errors are defined in the following List: 


Message 

LIBRARY TAPE CONTAINS NO DATA. 
PLEASE CHECK. ALTLIB IS ENDING 
WITH NO CHANGES TO YOUR FILE. 

TABLE OVERFLOW 


PERIOD OR PARENTHESIS MISSING 
FROM LOAD CARD 

READ ERROR 

INDEX TABLE OVERFLOW 


Definition 

The file supplied as parameter 2 of ALTLIB 
call card is blank. Check- out this file. 

Table storage has beeii exceeded. User pro- 
gram is not able to use ALTLIB in present 
form because of lack of storage. This 
problem is caused by exceeding storage 
when adding PIDL, ENTR/, and, EXTERNAL 
data or when forming the unique 
EXTERNALS list in ADDEXT. 

Incorrect parameters on A'L'TLIB card; see 
discussion of progrkm usage. • 

This is a message, caused by system malfunc- 
tion. It should never appear under normal 
running concUtions. , 

' . . . 1 * . ' . . i. 1 . I . . 

Library cannot exceed .5op^;^subpr,ograms. 

This is an arbitrary program limitation 
chosen when RANDOM , ACCESS’ FILE 
parameters were set. 
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Restrictions 


The following restrictions are imposed; 

(1) Central memory storage for tables of program-identification, entry, and external 
information is limited to 6000^0 words. 

(2) The alternate library is limited to 500 subprograms. 

(3) The following file names cannot be used for requested files in the user's pro- 
gram when using ALTLIB: 

FILE IQ 
FILE2Q 
FILE3Q 
ALTL95 


GENERAL INFORMATION 

ALTLIB is run at NASA Langley Research Center under a modified SCOPE 3.2 
system. ALTLIB should run as specified under any 6000 series operating system that 
Control Data Corporation (CDC) now has in use. 

There is one instruction ,(XJ) appearing in subprogram RCI that is a CDC option. 

It is used at locations 15, 47, and 62 in RCI. If an installation does not have this option, 
these instructions should be removed. The necessary code is in RCI to run with these 
instructions removed. If XJ is in the system being used, this code operates in a passive 
manner. 

Langley Research Center, 

National Aeronautics and Space Administration, 

Hampton, Va., November 24, 1971, 


REFERENCES 

1. Anon.: Control Data 6400/6500/6600 Computer Systems SCOPE 3.1 Reference Manual. 

Publ. No. 60189400 A, Control Data Corp., Feb. 1968. 

2. Anon.: Control Data 6400/6500/6600 Computer Systems FORTRAN Reference Manual. 

Publ. No. 60174900, Revision C, Control Data Corp., c.1969. 
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